

-> -> ENGLISH VERSION IS AT THE BELOW THE NETHERLANDISH VERSION <- <-


------- CGI-it pro 1.1 -------

HANDLEIDING

INHOUD


1   INSTALLATIE
1.2 BENODIGDE BESTANDEN

2   FUNCTIES
3   ONLINE ZETTEN VAN SCRIPT
4   HTML formulieren linken
5   COPYRIGHT

1 --- INSTALLATIE

U hebt dit programma gekregen in een zip-formaat, het maakt niet
uit waar u het programma uitpakt of wanneer enz. Maak een directory
en zet de hele reutemeteut erin. U kunt het programma nu gewoon draaien
van hardeschijf. Natuurlijk kunt u het ook op een diskette zetten
zodat u het programma altijd bij de hand hebt. Let er dan wel op dat
u ook de benodigde bestanden erbij zet.

1.2 --- BENODIGDE BESTANDEN

Als alles klopt hebt u de volgende bestanden in uw ZIP file aangetroffen:

- header.txt (met HTML code)
- footer.txt (met HTML code)
- mailer.cgi (met de ALGEMENE CGI code)
- cgi-it.exe (het programma)
- readme.txt (het hulpbestand)

Deze bestanden heeft u perse nodig om het prgramma te draaien als u 
deze niet heeft zal het programma niet goed draaien.

Het programma heeft ook nog andere bestanden nodig, namelijk de 
Visual Basic runtime libraries,  u kunt deze gewoon downloaden bij
het volgende adres:	http://www.download.com
U tikt dan het volgende in: 'Visual basic' (zonder haakjes)
U kunt er ook nog 'runtime' achter plakken als dit eerste geen resultaat
oplevert, U moet de runtime libraries hebben van Visual Basic 6
en dus NIET van 5,4,3 enz.

Als u de bestanden heeft installeert u ze en u kunt het programma
gebruiken. 

LET OP: het is mogelijk dat de bestanden al reeds op uw computer
zijn geinstalleerd!


--- FUNCTIES

Als u het programma draait krijgt u 3 tabbladen te zien namelijk:

- Ontvanger
- Eigenschappen
- HTML

Op het tabblad 'ontvanger' staan de gegevens van degene die de gegevens
van het HTML formulier ontvangen.

Op het tabblad 'eigenschappen' staan kunt u de eigenschapen van het
CGI script aanpassen aan uw wensen.

Bij het tabblad HTML kunt u de layout van het CGI script aanpassen.
(HTML kennis is hierbij aanbevolen)

-- we gaan nu de tabladen een voor een doorlopen --

-=ONTVANGER=-

: De textbox 'ontvanger (email adres)'
	U vult hier het email adres in van degene die de resultaten
	van het formulier moet krijgen.
	LET OP!!!: U moet hier een e-mail adres in vullen met een '\'
	(zonder haakjes) voor het @-teken dus: naam\@provider.xx

: De checkbox 'variabel'
	U kunt deze checkbox aan of uit zetten als u hem uit zet
	is het een 'normaal' CGI script, alle resulaten worden
	naar 1 email adres gestuurd.
	Als u hem AAN zet kunt u de resulaten van het formulier
	naar iemand anders sturen. De 'klant' van uw website kan
	dan zelf invullen waar het formulier heen moet worden gestuurd.
	Hij kan dan bijvoorbeeld zijn eigen email adres invullen, zodat
	het formulier naar zichzelf word toegestuurd.
	LET OP: Als u de funcie activeerd moet er in uw formulier een
	tekstbox met de eigenschap NAME ingesteld op 'email' (zonder 
	haakjes) zijn! Ook moet u wat extra gegevens invullen op het
	tabblad 'eigenschappen'. Maar dat leg ik later uit.

-=Eigenschappen=-

: Tekstbox 'onderwerp'
	Hier vult u het onderwerp van het bericht in.
: Tekstbox 'bedankbericht'
	In deze tekstbox moet u invullen wat de gebruiker krijgt te
	zien als hij het formulier CORRECT ingevuld EN verstuurd heeft.
: Tekstbox 'PERL pad'
	Dit is een zeer belangrijke textbox!
	U vult hier het pad van uw perl programma in normaal is dit:
	#!/usr/bin/perl
	Als u dit niet zeker weet moet u contact opnemen met uw
	sever (bijvoorbeeld de helpdesk). Zij kunne u percies 
	informeren wat hier moet komen te staan.
	LET OP!!!: Deze tekstbox is lettertyp precies, dat houd dus
	in dat hoofdletter, kleine letters enz. Verschillen van elkaar!
: Tekstbox 'versie"
	Hier kunt u uw versie invullen. (max 3 characters)
	
: Tekstbox 'Mail prog'
	Hier moet het pas komen van het mailprogramma van uw server.
	Normaal is dit '/usr/sbin/sendmail' als u dit niet weet
	dient u dit te achterhalen, zie 'tekstbox 'Perl pad'.
: Tekstbox 'Homepage'
	U moet hier de URL (inclusief HTTP://) invullen van uw 
	homepage, hier wordt u heen gelinkt nadat de gebruiker
	de 'dank je wel' pagina heeft gezien.
: Tekstbox 'Titel"
	Hier moet u de titel van uw pagina in typen, uw CGI word
	als de titel (+ de extensie .CGI) opgeslagen
: Checkbox 'Reply'
	Als u bij het tabblad 'ontvanger' de checkbox 'variabel' 
	hebt aangevinkt houd dat in dat de gegevens van het formulier
	naar iedereen toegestuurd kan worden. Omdat toch nog een beetje
	te besturen moet u de textboxen onder 'reply' invullen.
	ALS REPLY AANSTAAT EN U SCHAKELT HEM UIT MOET U ER REKENING
	MEE HOUDEN DAT DE CHECKBOX BIJ 'ontvanger' OOK UIT GAAT!
: Textbox 'Verplichte velden'
	U kunt hier de velden invullen die door de gebruiker VERPLICHT
	moeten worden ingevuld voordat het formulier verstuurd word.
	U vult de NAME eigenschap in van de textbox in kwestie. Als
	u meer dan 1 verplicht veld wilt moet u gescheiden door een
	komma een lijst maken bijvoorbeeld:
	--  item1,item2,item3 -- einde voorbeeld
: Checkbox 'Laat variabelen nogmaals zien'
	Als u deze checkbox aanvinkt laat het CGI script de gegevens
	die de klant heeft ingevult nogmaals zien nat het versturen.
	De klant vult dus een keer het formulier in en krijgt de
	variabelen (bijvoorbeeld voor controle) nogmaals te zien.
: Checkbox 'Anti SPAM'
	Deze box aankruisen is niet aanbevolen, als u het toch wilt
	houd deze box het volgende in: u krijgt de URL van de website
	erbij gestuurd, als er dan iemand ongewenste email naar u
	stuurt kunt u achterhalen waar de email vandaan komt. 
	Als u dit vakje aankruist heeft dit geen effect op andere 
	onderdelen (bijvoorbeeld snelheid enz.)

-=HTML=-

Bij HTML kunt u de layout van uw Bedank, Bericht pagina veranderen.
Met de knop 'standaard' kunt u de standaard waarden tevoorschijn
halen.

Als u geen kennis van HTML heeft is het niet aan te raden om dit
zonder hulp te veranderen.
Het enigste wat u kunt veranderen is de titel (de zin, woorden die
worden weergegevens in de blauwe balk van de browser.

U doet dit als volgt:
	u ziet ergens tussen de tekst de volgende regel:
		'### -> -> Hier moet de TITEL <- <- ###'
	verander deze tekst in uw titel bijvoorbeeld:
		'Bedankt voor het versturen van de gegevens!'

LET OP!!!: Verander alleen deze tekst, en pak dus niet de '<TITLE>'
tekst erbij, die moet namelijk gewoon blijven staan.


----OPSLAAN VAN SCRIPT----

Druk op de button 'opslaan' u krijgt nu een melding waar het script
is opgeslagen.



--- ONLINE ZETTEN VAN HET SCRIPT

Als u het script wilt gaan gebruiken moet u het online (op het internet)
zetten. U gebruikt hiervoor een FTP programma (bijvoorbeeld WS FTP)

U moet op de volgende dingen letten:
	- ZET HEM ALTIJD ONLINE IN ASCII MODE!!!
	- Misschien moet hij in een speciale directory (cgi-bin)

Als u dit gedaan heeft, kunt u het script gebruiken.



--- HTML formulieren linken

In uw HTML formulier code moet als actie van het formulier het volgende
zijn:	ACTION="http://www.padvanuwebsite/cgi-bin/cginaam.cgi" 
met de methode POST!

Een goede actieregel zou dus zijn:

ACTION="http://tigerformulier.com/cgi-bin/mailer.cgi" METHOD=POST

Ook het HTML formulier moet online staan voordat het script GOED werkt.



---  Copyright

Dit programma is gemaakt door:
		Timon Bos in opdracht van TiGer websolutions
		(http://www.tigerwebsolutions.net)

U mag de DEMO overal gebruiken, en uitdelen.
De DEMO kan u 2x gebruiken en is gratis!.

De volledige versie kan u zoveel x gebruiken als u zelf wilt, kost
15,- en u krijgt er gratis support bij.

Wilt u meer informatie, mail ons: bos.1@hccnet.nl





>>>>>>>>>> ENGLISH VERSION <<<<<<<<<<


 -=GUIDE=-


Subjects:

1   INSTALLATION
1.2 NEEDED FILE's

2   FUNCTIONS
3   PUT THE SCRIPT ONLINE
4   Linking HTML forms
5   COPYRIGHT

1 --- INSTALLATIION

You've downloaded this program in ZIP format, it doesn't matter
in what directory you put the files, make a directory and put
everything in that directory. You can run the program from
the harddisk, if you unpack the program to a floppy, you can
run the program from a floppy.

1.2 --- NEEDED FILE's

If everything correct you've got the following file's

- header.txt (with HTML code)
- footer.txt (with HTML code)
- mailer.cgi (with the CGI code)
- cgi-it.exe (with the program)
- readme.txt (Helpme!)

This program NEEDS these file's, if you haven't got them
the program wil NOT run.

The program needs some other files to: The Visual Basic runtime libraries
You can simply download them at the following site:
		http://www.download.com

You need the runtime libraries of Visual Basic 6.0!

If you've installed the file's you can run the program! 

LET OP: het is mogelijk dat de bestanden al reeds op uw computer
zijn geinstalleerd!


--- FUNCTIIONS

If you run the program you get 3 tabs

- Recipient
- Properties
- HTML

At the tab 'Recipient' you can fill in the information about
the recipient

At the tab 'Properties' you can fill in the properties of the CGI

With the tab 'HTML' you can change the layout of the 'Thanks page'

-- below follows a discription of the options --

-=RECIPIENT=-

: De textbox 'Recipient'
	Here you fill the email adres of the recipient.
	WARNING: you need to put a '\' before the @

: De checkbox 'variabel'
	 Set this to true if you would like to have a message sent to the     
	 person that sent in the form.  Set it to false if you don't.          
	 The auto-reply will send whatever message you want.              
	 NOTE: In order for this to work, you MUST have an "email" field   
	 in your form,  not "e-mail" or any other spinoff.  

-=PROPERTIES=-

: Tekstbox 'subject'
	Fill in the subject of the email message
: Tekstbox 'message'
	Fill in the thanks message
: Tekstbox 'PERL pad'
	IMPORTANT!
	Fill in the path of perl on the server, this is standard:
	#!/usr/bin/perl
: Tekstbox 'version"
	Typ the version of the CGI. (max 3 characters)
: Tekstbox 'Mail prog'
	 This is where sendmail is on your server                                     
	 The most common path is /usr/sbin/sendmail                
	 Check with your server's webmaster for the path if you're unsure
: Tekstbox 'Homepage'
	 Change this to the URL for your webpage. This will be the link    
	 back to your page after the form has been submitted. 
: Tekstbox 'Title"
	Typ here the name of you're CGI, the program will save the CGI
	as the defined title here
: Checkbox 'Reply'
	 Set this to true if you would like to have a message sent to the     
	 person that sent in the form.  Set it to false if you don't.          
	 The auto-reply will send whatever message you want.              
	 NOTE: In order for this to work, you MUST have an "email" field   
	 in your form,  not "e-mail" or any other spinoff. 
: Textbox 'Needed fields'
	 This will tell the script if certain fields are required. 	    
	 Remember if you use this script on multiple forms, it's best to   
	 only require something such as "email" so that all of the forms   
	 will require that to be filled. If you require something like     
	 'color' on one form, but not others and you use the same script   
	 to process your forms, it will always will return an error on a   
	 form that doesn't have "color" as a variable. Again, you should   
	 only put something like "email" that will be used in all forms    
	 unless you want to use multiple versions of this script (each     
	 configured individually). The variable can be specified in the    
	 "name" tag of an input box.   
		--  item1,item2,item3 -- 
: Checkbox 'Laat variabelen nogmaals zien'
	 Set this variable to equal true if you want the script to show the   
	 user the information they submitted.  It will show the entry      
	 field along with the value they entered, just as you do in the    
	 email you receive.  Set it to false if you don't want them to see it. 
                                                                   
	 If this is enabled along with the auto-reply, the user will see   
	 what they submitted on the thank you page as well as in the reply 
	 email they receive. 
: Checkbox 'Anti SPAM'
	 Set this to 1 if you would like the URL that used the script to   
	 get sent in the email.  This is very useful if you're getting     
	 spammed from somebody on another server that is either leeching   
	 off of your script or has put your email address in the email     
	 field above.                                                      
	 This will not send the URL to the person who sent the form in if  
	 you have enabled auto-reply.  

-=HTML=-

Here you can change the layout of the HTML page

Change the following text
		'### -> -> Hier moet de TITEL <- <- ###'
	in a nice title
	example
		'Thanx for sending the information'


----SAVE THE SCRIPT----

Push the 'Save' button and the script will be saved!


--- PUT THE SCRIPT ONLINE

U moet op de volgende dingen letten:
	- PUT THE SCRIPT ALWAYS IN ASCII MODE!!!
	- MAYBE THE SCRIPT MUST IN A SPECIAL DIRECTORY (cgi-bin)

I've you've done this you can use the script



--- linking HTML forms

You must put the following line in you're HTML form
ACTION="http://www.youresite/cgi-bin/cginame.cgi" 

with the method = POST!

A good line would be:

ACTION="http://tigerformulier.com/cgi-bin/mailer.cgi" METHOD=POST


---  Copyright

This program is created by:
		Timon Bos in opdracht van TiGer websolutions
		(http://www.tigerwebsolutions.net)

>>> You can use the DEMO only 3 TIMES

If you want to buy the full version, mail us! (only in the netherlands)

more information? : bos.1@hccnet.nl

NOTE: sorry for the bad english

-----end document-----






